New Calendar

- Added Barbados by ludsoft.

Fixes

- Added isolated tests for shifting mechanics in USA calendars - previously untested (335).
- Added Berlin specific holidays (340).
- Added several one-off public holidays to UK calendar (366).

New calendars

- Added several US territories and other specific calendars:
- American Samoa territory (218).
- Chicago, Illinois (220).
- Guam territory (219).
- Suffolk County, Massachusetts (222).
- Added Cayman Islands, British Overseas Territory (328)

New calendars

**WARNING** Scotland (sub)calendars are highly experimental and because of their very puzzling rules, may be false. Please use them with care.

- Added Scotland calendars, i.e. Scotland, Aberdeen, Angus, Arbroath, Ayr, Carnoustie & Monifieth, Clydebank, Dumfries & Galloway, Dundee, East Dunbartonshire, Edinburgh, Elgin, Falkirk, Fife, Galashiels, Glasgow, Hawick, Inverclyde, Inverness, Kilmarnock, Lochaber, Monifieth, North Lanarkshire, Paisley, Perth, Scottish Borders, South Lanarkshire, Stirling, and West Dunbartonshire (31).

Bugfixes

- Fixed United Kingdom bank holiday for 2002 and 2012, thx ludsoft (315).
- Fix a small flake8 issue with wrong indentation (319).
- Fix Russia "Day of Unity" date, set to November 4th, thx alexitkes for the bug report (317).

- Solved the incompatibility between `pandas` latest version and Python 3.4. Upgraded travis distro to Xenial/16.04 LTS (307).
- Added instructions about the usage of the `iso_register` decorator in the pull-request template (309).

New Calendars

- Added New Zealand, by johnguant (306).
- Added Paraguay calendar, following the work of reichert (268).
- Added China calendar, by iamsk (304).
- Added Israel, by armona, tsehori (281).

Bugfixes

- Added DEEPAVALI days for 2019 and 2020, thx pvalenti (282).
- Fixed Germany Reformation Day miscalculation. Some German states include Reformation Day since the "beginning" ; in 2017, all states included Reformation Day as a holiday (500th anniversary of the Reformation) ; starting of 2018, 4 states added Reformation Day (295).

New Calendars

- Added China, by iamsk.

Bugfix

- Fixed ISO 3166-1 code for the `Slovenia` calendar (291, thx john-sandall).

Major changes

- Added support for Python 3.7 (283).
- Fixed the `SouthAfrica` holidays calendar, taking into account the specs of holidays that vary over the periods. As a consequence, it cleaned up erroneous holidays that were duplicated in some years (285). Thx to surfer190 for his review & suggestions.
- Bugfix for South Africa: disabled the possibility to compute holidays prior to the year 1910.

Minor changes

- Renamed Madagascar test class name into `MadagascarTest` (286).
- Separated the coverage jobs from the pure tests. Their report output was disturbing in development mode, you had to scroll your way up to find eventual failing tests (289).

Major changes

Large work on global registry: refs 13, 96, 257 & 284.

- Added Tests for Europe registry.
- Revamped and cleaned up Europe countries.
- Added the United States of America + States, American countries & sub-regions, African countries, Asian countries, Oceanian countries.
- The global registry usage is documented.

Breaking changes

- Changed Canada namespace to `workalendar.america.canada`.
- You don't have to declare a `name` properties for Calendar classes. It will be deducted from the docstring.
- Changed the `registry.items()` mandatory argument name to `region_codes` for more readability.

New Calendars

- Added Angola, by dvdmgl (276)

Bugfixes

- Portugal - removed carnival from Portuguese holidays, restored missing holidays (275)

Other changes

- Added All Souls Day to common (274)
- Allow the `add_working_days()` function to be provided a datetime, and returning a `date` (270).
- Added a `keep_datetime` option to keep the original type of the input argument for both ``add_working_days()`` and ``sub_working_days()`` functions (270).
- Fixed usage examples of ``get_first_weekday_after()`` docstring + in code (calendars and tests) ; do not use magic values, use MON, TUE, etc (271).
- Turned Changelog into a Markdown file (272).
- Added basic usage documentation, hosted by Github pages.
- Added advanced usage documentation.

- Bugfix: deduplicate South Africa holidays that were emitted as duplicates (265).
- Add the `get_working_days_delta` method to the core calendar class (260).

New Calendars

- Added Lithuania, by landler (254).
- Added Russia, by vanadium23 (259).

Bugfixes

- Fixed shifting ANZAC day for Australia states (249).
- Renamed Australian state classes to actual state names(eg. AustraliaNewSouthWales to NewSouthWales).
- Update ACT holidays (251).
- Fixing Federal Christmas Shift ; added a `include_veterans_day` flag to enable/disable Veteran's day on specific calendar - e.g. Mozilla's dedicated calendar (242).

Other

- **Deprecation:** Dropped support for Python 3.3 (245).
- Fixed Travis-ci configuration for Python 3.5 and al (252).
- Moved from `novafloss` to the `peopledoc` organization, the core People Doc Inc. organization (255).
- First step iteration on the "global registry" feature. European countries are now part of a registry loaded in the ``workalendar.registry`` module. Please use with care at the moment (248).
- Refactored Australia family and community day calculation (244).